home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Environments / Small Eiffel 0.4.8 / man / cecil.hlp next >
Text File  |  1997-04-13  |  1KB  |  31 lines
  1. Read this file if you want to call some Eiffel features from C 
  2. code (to call C functions/macros from Eiffel see external.hlp).
  3.  
  4. In order to call some Eiffel feature from C, you must use the 
  5. -cecil <cecil_file> option with command `compile' or `compile_to_c'.
  6. The <cecil_file> allow you to give the list of features you want to
  7. call from C.
  8. When the -cecil option is used, command `compile_to_c' produce 
  9. an additional C heading file which includes the needed C prototypes.
  10.  
  11. The <cecil_file> must have at least two lines. The first line is the 
  12. name of the C heading file to produce (it may be useful if you need
  13. to create a C library). Other lines have the following structure :
  14.  
  15.     <c_name> <living_type> <feature_name>
  16.  
  17. The <c_name> is the name of the C function defined by `compile_to_c' 
  18. to wrap the Eiffel call. The couple <living_type> <feature_name> 
  19. gives the complete name of the Eiffel feature to call.
  20.  
  21. Keep in mind that the <living_type> must be really `alive' :
  22. if <living_type> is ARRAY[INTEGER] for example, your Eiffel program
  23. is suppose to create at least one ARRAY[INTEGER].
  24. The name of the feature to call, <feature_name> may be an infix or
  25. a prefix feature name (the syntax if the same as the one used in 
  26. Eiffel source).
  27. As <cecil_file> is parsed by the SmallEiffel parser, it may contains 
  28. Eiffel comments.
  29.  
  30. See examples in directory SmallEiffel/lib_show/cecil/example*.
  31.